<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Selections</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
<link rel="home" href="index.html" title="GTK+ Reference Manual">
<link rel="up" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="prev" href="GtkStyle.html" title="Styles">
<link rel="next" href="gtk-Feature-Test-Macros.html" title="Version Information">
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="ch02.html" title="Widget Gallery">
<link rel="chapter" href="WindowWidgets.html" title="Windows">
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
<link rel="chapter" href="Ornaments.html" title="Ornaments">
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
<link rel="chapter" href="Printing.html" title="Printing">
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
<link rel="chapter" href="Builder.html" title="Interface builder">
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry">
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
<link rel="chapter" href="gtk-migrating-GtkBuilder.html" title="Migrating from libglade to GtkBuilder">
<link rel="chapter" href="gtk-migrating-tooltips.html" title="Migrating from GtkTooltips to GtkTooltip">
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
<link rel="glossary" href="glossary.html" title="Glossary">
<link rel="index" href="api-index-full.html" title="Index of all symbols">
<link rel="index" href="api-index-deprecated.html" title="Index of deprecated symbols">
<link rel="index" href="api-index-2-2.html" title="Index of new symbols in 2.2">
<link rel="index" href="api-index-2-4.html" title="Index of new symbols in 2.4">
<link rel="index" href="api-index-2-6.html" title="Index of new symbols in 2.6">
<link rel="index" href="api-index-2-8.html" title="Index of new symbols in 2.8">
<link rel="index" href="api-index-2-10.html" title="Index of new symbols in 2.10">
<link rel="index" href="api-index-2-12.html" title="Index of new symbols in 2.12">
<link rel="index" href="api-index-2-14.html" title="Index of new symbols in 2.14">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkStyle.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="gtkbase.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ Reference Manual</th>
<td><a accesskey="n" href="gtk-Feature-Test-Macros.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#gtk-Selections.synopsis" class="shortcut">Top</a>
                 | 
                <a href="#gtk-Selections.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry" lang="en">
<a name="gtk-Selections"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="gtk-Selections.top_of_page"></a>Selections</span></h2>
<p>Selections — Functions for handling inter-process communication via selections</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="gtk-Selections.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">

#include &lt;gtk/gtk.h&gt;

                    <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry">GtkTargetEntry</a>;
                    <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a>;
                    <a class="link" href="gtk-Selections.html#GtkTargetPair" title="GtkTargetPair">GtkTargetPair</a>;
<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *     <a class="link" href="gtk-Selections.html#gtk-target-list-new" title="gtk_target_list_new ()">gtk_target_list_new</a>                 (const <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry">GtkTargetEntry</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> ntargets);
<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *     <a class="link" href="gtk-Selections.html#gtk-target-list-ref" title="gtk_target_list_ref ()">gtk_target_list_ref</a>                 (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list);
void                <a class="link" href="gtk-Selections.html#gtk-target-list-unref" title="gtk_target_list_unref ()">gtk_target_list_unref</a>               (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list);
void                <a class="link" href="gtk-Selections.html#gtk-target-list-add" title="gtk_target_list_add ()">gtk_target_list_add</a>                 (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> target,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> flags,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> info);
void                <a class="link" href="gtk-Selections.html#gtk-target-list-add-table" title="gtk_target_list_add_table ()">gtk_target_list_add_table</a>           (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         const <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry">GtkTargetEntry</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> ntargets);
void                <a class="link" href="gtk-Selections.html#gtk-target-list-add-text-targets" title="gtk_target_list_add_text_targets ()">gtk_target_list_add_text_targets</a>    (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> info);
void                <a class="link" href="gtk-Selections.html#gtk-target-list-add-image-targets" title="gtk_target_list_add_image_targets ()">gtk_target_list_add_image_targets</a>   (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> info,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> writable);
void                <a class="link" href="gtk-Selections.html#gtk-target-list-add-uri-targets" title="gtk_target_list_add_uri_targets ()">gtk_target_list_add_uri_targets</a>     (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> info);
void                <a class="link" href="gtk-Selections.html#gtk-target-list-add-rich-text-targets" title="gtk_target_list_add_rich_text_targets ()">gtk_target_list_add_rich_text_targets</a>
                                                        (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> info,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> deserializable,
                                                         <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer">GtkTextBuffer</a> *buffer);
void                <a class="link" href="gtk-Selections.html#gtk-target-list-remove" title="gtk_target_list_remove ()">gtk_target_list_remove</a>              (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> target);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-target-list-find" title="gtk_target_list_find ()">gtk_target_list_find</a>                (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> target,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> *info);
void                <a class="link" href="gtk-Selections.html#gtk-target-table-free" title="gtk_target_table_free ()">gtk_target_table_free</a>               (<a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry">GtkTargetEntry</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_targets);
<a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry">GtkTargetEntry</a> *    <a class="link" href="gtk-Selections.html#gtk-target-table-new-from-list" title="gtk_target_table_new_from_list ()">gtk_target_table_new_from_list</a>      (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *n_targets);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-owner-set" title="gtk_selection_owner_set ()">gtk_selection_owner_set</a>             (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> selection,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> time_);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-owner-set-for-display" title="gtk_selection_owner_set_for_display ()">gtk_selection_owner_set_for_display</a> (<a
href="/usr/share/gtk-doc/html/gdk/GdkDisplay.html"
>GdkDisplay</a> *display,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> selection,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> time_);
void                <a class="link" href="gtk-Selections.html#gtk-selection-add-target" title="gtk_selection_add_target ()">gtk_selection_add_target</a>            (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> selection,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> target,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> info);
void                <a class="link" href="gtk-Selections.html#gtk-selection-add-targets" title="gtk_selection_add_targets ()">gtk_selection_add_targets</a>           (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> selection,
                                                         const <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry">GtkTargetEntry</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> ntargets);
void                <a class="link" href="gtk-Selections.html#gtk-selection-clear-targets" title="gtk_selection_clear_targets ()">gtk_selection_clear_targets</a>         (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> selection);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-convert" title="gtk_selection_convert ()">gtk_selection_convert</a>               (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> selection,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> target,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> time_);
void                <a class="link" href="gtk-Selections.html#gtk-selection-data-set" title="gtk_selection_data_set ()">gtk_selection_data_set</a>              (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> format,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"
>guchar</a> *data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> length);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-data-set-text" title="gtk_selection_data_set_text ()">gtk_selection_data_set_text</a>         (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *str,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> len);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"
>guchar</a> *            <a class="link" href="gtk-Selections.html#gtk-selection-data-get-text" title="gtk_selection_data_get_text ()">gtk_selection_data_get_text</a>         (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-data-set-pixbuf" title="gtk_selection_data_set_pixbuf ()">gtk_selection_data_set_pixbuf</a>       (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         <a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a> *pixbuf);
<a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a> *         <a class="link" href="gtk-Selections.html#gtk-selection-data-get-pixbuf" title="gtk_selection_data_get_pixbuf ()">gtk_selection_data_get_pixbuf</a>       (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-data-set-uris" title="gtk_selection_data_set_uris ()">gtk_selection_data_set_uris</a>         (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **uris);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **            <a class="link" href="gtk-Selections.html#gtk-selection-data-get-uris" title="gtk_selection_data_get_uris ()">gtk_selection_data_get_uris</a>         (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-data-get-targets" title="gtk_selection_data_get_targets ()">gtk_selection_data_get_targets</a>      (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> **targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *n_atoms);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-data-targets-include-image" title="gtk_selection_data_targets_include_image ()">gtk_selection_data_targets_include_image</a>
                                                        (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> writable);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-data-targets-include-text" title="gtk_selection_data_targets_include_text ()">gtk_selection_data_targets_include_text</a>
                                                        (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-data-targets-include-uri" title="gtk_selection_data_targets_include_uri ()">gtk_selection_data_targets_include_uri</a>
                                                        (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-data-targets-include-rich-text" title="gtk_selection_data_targets_include_rich_text ()">gtk_selection_data_targets_include_rich_text</a>
                                                        (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer">GtkTextBuffer</a> *buffer);
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"
>guchar</a> *      <a class="link" href="gtk-Selections.html#gtk-selection-data-get-data" title="gtk_selection_data_get_data ()">gtk_selection_data_get_data</a>         (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                <a class="link" href="gtk-Selections.html#gtk-selection-data-get-length" title="gtk_selection_data_get_length ()">gtk_selection_data_get_length</a>       (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);
<a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a>             <a class="link" href="gtk-Selections.html#gtk-selection-data-get-data-type" title="gtk_selection_data_get_data_type ()">gtk_selection_data_get_data_type</a>    (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);
<a
href="/usr/share/gtk-doc/html/gdk/GdkDisplay.html"
>GdkDisplay</a> *        <a class="link" href="gtk-Selections.html#gtk-selection-data-get-display" title="gtk_selection_data_get_display ()">gtk_selection_data_get_display</a>      (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                <a class="link" href="gtk-Selections.html#gtk-selection-data-get-format" title="gtk_selection_data_get_format ()">gtk_selection_data_get_format</a>       (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);
<a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a>             <a class="link" href="gtk-Selections.html#gtk-selection-data-get-target" title="gtk_selection_data_get_target ()">gtk_selection_data_get_target</a>       (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-targets-include-image" title="gtk_targets_include_image ()">gtk_targets_include_image</a>           (<a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> writable);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-targets-include-text" title="gtk_targets_include_text ()">gtk_targets_include_text</a>            (<a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_targets);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-targets-include-uri" title="gtk_targets_include_uri ()">gtk_targets_include_uri</a>             (<a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_targets);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-targets-include-rich-text" title="gtk_targets_include_rich_text ()">gtk_targets_include_rich_text</a>       (<a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_targets,
                                                         <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer">GtkTextBuffer</a> *buffer);
void                <a class="link" href="gtk-Selections.html#gtk-selection-remove-all" title="gtk_selection_remove_all ()">gtk_selection_remove_all</a>            (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-clear" title="gtk_selection_clear ()">gtk_selection_clear</a>                 (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Event-Structures.html#GdkEventSelection"
>GdkEventSelection</a> *event);
<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *  <a class="link" href="gtk-Selections.html#gtk-selection-data-copy" title="gtk_selection_data_copy ()">gtk_selection_data_copy</a>             (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *data);
void                <a class="link" href="gtk-Selections.html#gtk-selection-data-free" title="gtk_selection_data_free ()">gtk_selection_data_free</a>             (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *data);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="gtk-Selections.description"></a><h2>Description</h2>
<p>
The selection mechanism provides the basis for different types
of communication between processes. In particular, drag and drop and
<a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> work via selections. You will very seldom or
never need to use most of the functions in this section directly;
<a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> provides a nicer interface to the same functionality.
</p>
<p>
Some of the datatypes defined this section are used in
the <a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> and drag-and-drop API's as well. The
<a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> structure and <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a> objects represent
lists of data types that are supported when sending or
receiving data. The <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> object is used to
store a chunk of data along with the data type and other
associated information.
</p>
</div>
<div class="refsect1" lang="en">
<a name="gtk-Selections.details"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="GtkTargetEntry"></a><h3>GtkTargetEntry</h3>
<pre class="programlisting">typedef struct {
  gchar *target;
  guint  flags;
  guint  info;
} GtkTargetEntry;
</pre>
<p>
A <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> structure represents a single type of
data than can be supplied for by a widget for a selection
or for supplied or received during drag-and-drop. It
contains a string representing the drag type, a flags
field (used only for drag and drop - see <a class="link" href="gtk-Drag-and-Drop.html#GtkTargetFlags" title="enum GtkTargetFlags"><span class="type">GtkTargetFlags</span></a>),
and an application assigned integer ID. The integer
ID will later be passed as a signal parameter for signals
like "selection_get". It allows the application to identify
the target type without extensive string compares.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkTargetList"></a><h3>GtkTargetList</h3>
<pre class="programlisting">typedef struct {
  GList *list;
  guint ref_count;
} GtkTargetList;
</pre>
<p>
A <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a> structure is a reference counted list
of <a class="link" href="gtk-Selections.html#GtkTargetPair" title="GtkTargetPair"><span class="type">GtkTargetPair</span></a>. It is used to represent the same
information as a table of <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a>, but in
an efficient form. This structure should be treated as
opaque.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkTargetPair"></a><h3>GtkTargetPair</h3>
<pre class="programlisting">typedef struct {
  GdkAtom   target;
  guint     flags;
  guint     info;
} GtkTargetPair;
</pre>
<p>
Internally used structure in the drag-and-drop and
selection handling code.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-target-list-new"></a><h3>gtk_target_list_new ()</h3>
<pre class="programlisting"><a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *     gtk_target_list_new                 (const <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry">GtkTargetEntry</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> ntargets);</pre>
<p>
Creates a new <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a> from an array of <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>targets</code></em> :</span></p></td>
<td> Pointer to an array of <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ntargets</code></em> :</span></p></td>
<td>  number of entries in <em class="parameter"><code>targets</code></em>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the new <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-target-list-ref"></a><h3>gtk_target_list_ref ()</h3>
<pre class="programlisting"><a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *     gtk_target_list_ref                 (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list);</pre>
<p>
Increases the reference count of a <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a> by one.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>  a <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the passed in <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-target-list-unref"></a><h3>gtk_target_list_unref ()</h3>
<pre class="programlisting">void                gtk_target_list_unref               (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list);</pre>
<p>
Decreases the reference count of a <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a> by one.
If the resulting reference count is zero, frees the list.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td> a <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-target-list-add"></a><h3>gtk_target_list_add ()</h3>
<pre class="programlisting">void                gtk_target_list_add                 (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> target,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> flags,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> info);</pre>
<p>
Appends another target to a <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>  a <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
<td> the interned atom representing the target
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
<td> the flags for this target
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> an ID that will be passed back to the application
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-target-list-add-table"></a><h3>gtk_target_list_add_table ()</h3>
<pre class="programlisting">void                gtk_target_list_add_table           (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         const <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry">GtkTargetEntry</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> ntargets);</pre>
<p>
Prepends a table of <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> to a target list.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td> a <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>targets</code></em> :</span></p></td>
<td> the table of <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ntargets</code></em> :</span></p></td>
<td> number of targets in the table
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-target-list-add-text-targets"></a><h3>gtk_target_list_add_text_targets ()</h3>
<pre class="programlisting">void                gtk_target_list_add_text_targets    (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> info);</pre>
<p>
Appends the text targets supported by <span class="type">GtkSelection</span> to
the target list. All targets are added with the same <em class="parameter"><code>info</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td> a <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> an ID that will be passed back to the application
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-target-list-add-image-targets"></a><h3>gtk_target_list_add_image_targets ()</h3>
<pre class="programlisting">void                gtk_target_list_add_image_targets   (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> info,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> writable);</pre>
<p>
Appends the image targets supported by <span class="type">GtkSelection</span> to
the target list. All targets are added with the same <em class="parameter"><code>info</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td> a <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> an ID that will be passed back to the application
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>writable</code></em> :</span></p></td>
<td> whether to add only targets for which GTK+ knows
  how to convert a pixbuf into the format
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-target-list-add-uri-targets"></a><h3>gtk_target_list_add_uri_targets ()</h3>
<pre class="programlisting">void                gtk_target_list_add_uri_targets     (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> info);</pre>
<p>
Appends the URI targets supported by <span class="type">GtkSelection</span> to
the target list. All targets are added with the same <em class="parameter"><code>info</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td> a <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> an ID that will be passed back to the application
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-target-list-add-rich-text-targets"></a><h3>gtk_target_list_add_rich_text_targets ()</h3>
<pre class="programlisting">void                gtk_target_list_add_rich_text_targets
                                                        (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> info,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> deserializable,
                                                         <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer">GtkTextBuffer</a> *buffer);</pre>
<p>
Appends the rich text targets registered with
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-format" title="gtk_text_buffer_register_serialize_format ()"><code class="function">gtk_text_buffer_register_serialize_format()</code></a> or
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-deserialize-format" title="gtk_text_buffer_register_deserialize_format ()"><code class="function">gtk_text_buffer_register_deserialize_format()</code></a> to the target list. All
targets are added with the same <em class="parameter"><code>info</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td> a <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> an ID that will be passed back to the application
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>deserializable</code></em> :</span></p></td>
<td> if <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a>, then deserializable rich text formats
                 will be added, serializable formats otherwise.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>buffer</code></em> :</span></p></td>
<td> a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a>.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.10</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-target-list-remove"></a><h3>gtk_target_list_remove ()</h3>
<pre class="programlisting">void                gtk_target_list_remove              (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> target);</pre>
<p>
Removes a target from a target list.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td> a <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
<td> the interned atom representing the target
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-target-list-find"></a><h3>gtk_target_list_find ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_target_list_find                (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> target,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> *info);</pre>
<p>
Looks up a given target in a <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td> a <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
<td> an interned atom representing the target to search for
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> a pointer to the location to store application info for target,
       or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if the target was found, otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-target-table-free"></a><h3>gtk_target_table_free ()</h3>
<pre class="programlisting">void                gtk_target_table_free               (<a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry">GtkTargetEntry</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_targets);</pre>
<p>
This function frees a target table as returned by
<a class="link" href="gtk-Selections.html#gtk-target-table-new-from-list" title="gtk_target_table_new_from_list ()"><code class="function">gtk_target_table_new_from_list()</code></a></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>targets</code></em> :</span></p></td>
<td> a <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> array
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_targets</code></em> :</span></p></td>
<td> the number of entries in the array
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.10</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-target-table-new-from-list"></a><h3>gtk_target_table_new_from_list ()</h3>
<pre class="programlisting"><a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry">GtkTargetEntry</a> *    gtk_target_table_new_from_list      (<a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *n_targets);</pre>
<p>
This function creates an <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> array that contains the
same targets as the passed <code class="literal">list</code>. The returned table is newly
allocated and should be freed using <a class="link" href="gtk-Selections.html#gtk-target-table-free" title="gtk_target_table_free ()"><code class="function">gtk_target_table_free()</code></a> when no
longer needed.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td> a <a class="link" href="gtk-Selections.html#GtkTargetList" title="GtkTargetList"><span class="type">GtkTargetList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_targets</code></em> :</span></p></td>
<td> return location for the number ot targets in the table
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the new table.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.10</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-owner-set"></a><h3>gtk_selection_owner_set ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_selection_owner_set             (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> selection,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> time_);</pre>
<p>
Claims ownership of a given selection for a particular widget,
or, if <em class="parameter"><code>widget</code></em> is <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>, release ownership of the selection.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>  a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
<td>  an interned atom representing the selection to claim
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
<td> timestamp with which to claim the selection
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if the operation succeeded
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-owner-set-for-display"></a><h3>gtk_selection_owner_set_for_display ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_selection_owner_set_for_display (<a
href="/usr/share/gtk-doc/html/gdk/GdkDisplay.html"
>GdkDisplay</a> *display,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> selection,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> time_);</pre>
<p>
Claim ownership of a given selection for a particular widget, or,
if <em class="parameter"><code>widget</code></em> is <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>, release ownership of the selection.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>display</code></em> :</span></p></td>
<td> the <span class="type">Gdkdisplay</span> where the selection is set 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td> new selection owner (a <span class="type">GdkWidget</span>), or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
<td> an interned atom representing the selection to claim.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
<td> timestamp with which to claim the selection
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> TRUE if the operation succeeded 

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-add-target"></a><h3>gtk_selection_add_target ()</h3>
<pre class="programlisting">void                gtk_selection_add_target            (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> selection,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> target,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> info);</pre>
<p>
Appends a specified target to the list of supported targets for a 
given widget and selection.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>  a <span class="type">GtkTarget</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
<td> the selection
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
<td> target to add.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
<td> A unsigned integer which will be passed back to the application.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-add-targets"></a><h3>gtk_selection_add_targets ()</h3>
<pre class="programlisting">void                gtk_selection_add_targets           (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> selection,
                                                         const <a class="link" href="gtk-Selections.html#GtkTargetEntry" title="GtkTargetEntry">GtkTargetEntry</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> ntargets);</pre>
<p>
Prepends a table of targets to the list of supported targets
for a given widget and selection.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td> a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
<td> the selection
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>targets</code></em> :</span></p></td>
<td> a table of targets to add
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ntargets</code></em> :</span></p></td>
<td>  number of entries in <em class="parameter"><code>targets</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-clear-targets"></a><h3>gtk_selection_clear_targets ()</h3>
<pre class="programlisting">void                gtk_selection_clear_targets         (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> selection);</pre>
<p>
Remove all targets registered for the given selection for the
widget.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>    a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
<td> an atom representing a selection
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-convert"></a><h3>gtk_selection_convert ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_selection_convert               (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> selection,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> target,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> time_);</pre>
<p>
Requests the contents of a selection. When received, 
a "selection-received" signal will be generated.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td> The widget which acts as requestor
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection</code></em> :</span></p></td>
<td> Which selection to get
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
<td> Form of information desired (e.g., STRING)
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
<td> Time of request (usually of triggering event)
       In emergency, you could use <a
href="/usr/share/gtk-doc/html/gdk/gdk-Events.html#GDK-CURRENT-TIME--CAPS"
><span class="type">GDK_CURRENT_TIME</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if requested succeeded. <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a> if we could not process
         request. (e.g., there was already a request in process for
         this widget).
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-set"></a><h3>gtk_selection_data_set ()</h3>
<pre class="programlisting">void                gtk_selection_data_set              (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> format,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"
>guchar</a> *data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> length);</pre>
<p>
Stores new data into a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> object. Should
<span class="emphasis"><em>only</em></span> be called from a selection handler callback.
Zero-terminates the stored data.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a pointer to a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> structure.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
<td> the type of selection data
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
<td> format (number of bits in a unit)
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
<td> pointer to the data (will be copied)
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
<td> length of the data
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-set-text"></a><h3>gtk_selection_data_set_text ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_selection_data_set_text         (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *str,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> len);</pre>
<p>
Sets the contents of the selection from a UTF-8 encoded string.
The string is converted to the form determined by
<em class="parameter"><code>selection_data-&gt;target</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
<td> a UTF-8 string
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
<td> the length of <em class="parameter"><code>str</code></em>, or -1 if <em class="parameter"><code>str</code></em> is nul-terminated.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if the selection was successfully set,
  otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-get-text"></a><h3>gtk_selection_data_get_text ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"
>guchar</a> *            gtk_selection_data_get_text         (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);</pre>
<p>
Gets the contents of the selection data as a UTF-8 string.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> if the selection data contained a recognized
  text type and it could be converted to UTF-8, a newly allocated
  string containing the converted text, otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>.
  If the result is non-<a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a> it must be freed with <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-set-pixbuf"></a><h3>gtk_selection_data_set_pixbuf ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_selection_data_set_pixbuf       (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         <a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a> *pixbuf);</pre>
<p>
Sets the contents of the selection from a <a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a>
The pixbuf is converted to the form determined by
<em class="parameter"><code>selection_data-&gt;target</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if the selection was successfully set,
  otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-get-pixbuf"></a><h3>gtk_selection_data_get_pixbuf ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a> *         gtk_selection_data_get_pixbuf       (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);</pre>
<p>
Gets the contents of the selection data as a <a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> if the selection data contained a recognized
  image type and it could be converted to a <a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a>, a 
  newly allocated pixbuf is returned, otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>.
  If the result is non-<a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a> it must be freed with <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"
><code class="function">g_object_unref()</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-set-uris"></a><h3>gtk_selection_data_set_uris ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_selection_data_set_uris         (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **uris);</pre>
<p>
Sets the contents of the selection from a list of URIs.
The string is converted to the form determined by
<em class="parameter"><code>selection_data-&gt;target</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uris</code></em> :</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>-terminated array of strings hilding URIs
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if the selection was successfully set,
  otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-get-uris"></a><h3>gtk_selection_data_get_uris ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **            gtk_selection_data_get_uris         (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);</pre>
<p>
Gets the contents of the selection data as array of URIs.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> if the selection data contains a list of
  URIs, a newly allocated <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>-terminated string array
  containing the URIs, otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>. If the result is 
  non-<a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a> it must be freed with <a
href="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#g-strfreev"
><code class="function">g_strfreev()</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-get-targets"></a><h3>gtk_selection_data_get_targets ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_selection_data_get_targets      (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> **targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *n_atoms);</pre>
<p>
Gets the contents of <em class="parameter"><code>selection_data</code></em> as an array of targets.
This can be used to interpret the results of getting
the standard TARGETS target that is always supplied for
any selection.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>targets</code></em> :</span></p></td>
<td> location to store an array of targets. The result
          stored here must be freed with <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_atoms</code></em> :</span></p></td>
<td> location to store number of items in <em class="parameter"><code>targets</code></em>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if <em class="parameter"><code>selection_data</code></em> contains a valid
   array of targets, otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-targets-include-image"></a><h3>gtk_selection_data_targets_include_image ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_selection_data_targets_include_image
                                                        (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> writable);</pre>
<p>
Given a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> object holding a list of targets,
determines if any of the targets in <em class="parameter"><code>targets</code></em> can be used to
provide a <a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>writable</code></em> :</span></p></td>
<td> whether to accept only targets for which GTK+ knows
  how to convert a pixbuf into the format
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if <em class="parameter"><code>selection_data</code></em> holds a list of targets,
  and a suitable target for images is included, otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.6</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-targets-include-text"></a><h3>gtk_selection_data_targets_include_text ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_selection_data_targets_include_text
                                                        (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);</pre>
<p>
Given a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> object holding a list of targets,
determines if any of the targets in <em class="parameter"><code>targets</code></em> can be used to
provide text.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if <em class="parameter"><code>selection_data</code></em> holds a list of targets,
  and a suitable target for text is included, otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-targets-include-uri"></a><h3>gtk_selection_data_targets_include_uri ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_selection_data_targets_include_uri
                                                        (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);</pre>
<p>
Given a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> object holding a list of targets,
determines if any of the targets in <em class="parameter"><code>targets</code></em> can be used to
provide a list or URIs.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if <em class="parameter"><code>selection_data</code></em> holds a list of targets,
  and a suitable target for URI lists is included, otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.10</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-targets-include-rich-text"></a><h3>gtk_selection_data_targets_include_rich_text ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_selection_data_targets_include_rich_text
                                                        (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer">GtkTextBuffer</a> *buffer);</pre>
<p>
Given a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> object holding a list of targets,
determines if any of the targets in <em class="parameter"><code>targets</code></em> can be used to
provide rich text.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>buffer</code></em> :</span></p></td>
<td> a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if <em class="parameter"><code>selection_data</code></em> holds a list of targets,
              and a suitable target for rich text is included,
              otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.10</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-get-data"></a><h3>gtk_selection_data_get_data ()</h3>
<pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"
>guchar</a> *      gtk_selection_data_get_data         (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);</pre>
<p>
Retrieves the raw data of the selection.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a pointer to a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> structure.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the raw data of the selection.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-get-length"></a><h3>gtk_selection_data_get_length ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gtk_selection_data_get_length       (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);</pre>
<p>
Retrieves the length of the raw data of the selection.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a pointer to a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> structure.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the length of the data of the selection.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-get-data-type"></a><h3>gtk_selection_data_get_data_type ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a>             gtk_selection_data_get_data_type    (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);</pre>
<p>
Retrieves the data type of the selection.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a pointer to a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> structure.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>  the data type of the selection.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-get-display"></a><h3>gtk_selection_data_get_display ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gdk/GdkDisplay.html"
>GdkDisplay</a> *        gtk_selection_data_get_display      (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);</pre>
<p>
Retrieves the display of the selection.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a pointer to a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> structure.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the display of the selection.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-get-format"></a><h3>gtk_selection_data_get_format ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gtk_selection_data_get_format       (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);</pre>
<p>
Retrieves the format of the selection.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a pointer to a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> structure.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the format of the selection.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-get-target"></a><h3>gtk_selection_data_get_target ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a>             gtk_selection_data_get_target       (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *selection_data);</pre>
<p>
Retrieves the target of the selection.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_data</code></em> :</span></p></td>
<td> a pointer to a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> structure.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>  the target of the selection.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-targets-include-image"></a><h3>gtk_targets_include_image ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_targets_include_image           (<a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> writable);</pre>
<p>
Determines if any of the targets in <em class="parameter"><code>targets</code></em> can be used to
provide a <a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>targets</code></em> :</span></p></td>
<td> an array of <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
><span class="type">GdkAtom</span></a>s
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_targets</code></em> :</span></p></td>
<td> the length of <em class="parameter"><code>targets</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>writable</code></em> :</span></p></td>
<td> whether to accept only targets for which GTK+ knows
  how to convert a pixbuf into the format
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if <em class="parameter"><code>targets</code></em> include a suitable target for images,
  otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.10</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-targets-include-text"></a><h3>gtk_targets_include_text ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_targets_include_text            (<a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_targets);</pre>
<p>
Determines if any of the targets in <em class="parameter"><code>targets</code></em> can be used to
provide text.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>targets</code></em> :</span></p></td>
<td> an array of <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
><span class="type">GdkAtom</span></a>s
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_targets</code></em> :</span></p></td>
<td> the length of <em class="parameter"><code>targets</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if <em class="parameter"><code>targets</code></em> include a suitable target for text,
  otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.10</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-targets-include-uri"></a><h3>gtk_targets_include_uri ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_targets_include_uri             (<a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_targets);</pre>
<p>
Determines if any of the targets in <em class="parameter"><code>targets</code></em> can be used to
provide an uri list.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>targets</code></em> :</span></p></td>
<td> an array of <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
><span class="type">GdkAtom</span></a>s
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_targets</code></em> :</span></p></td>
<td> the length of <em class="parameter"><code>targets</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if <em class="parameter"><code>targets</code></em> include a suitable target for uri lists,
  otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.10</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-targets-include-rich-text"></a><h3>gtk_targets_include_rich_text ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_targets_include_rich_text       (<a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_targets,
                                                         <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer">GtkTextBuffer</a> *buffer);</pre>
<p>
Determines if any of the targets in <em class="parameter"><code>targets</code></em> can be used to
provide rich text.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>targets</code></em> :</span></p></td>
<td> an array of <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
><span class="type">GdkAtom</span></a>s
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_targets</code></em> :</span></p></td>
<td> the length of <em class="parameter"><code>targets</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>buffer</code></em> :</span></p></td>
<td> a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if <em class="parameter"><code>targets</code></em> include a suitable target for rich text,
              otherwise <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE--CAPS"
><code class="literal">FALSE</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.10</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-remove-all"></a><h3>gtk_selection_remove_all ()</h3>
<pre class="programlisting">void                gtk_selection_remove_all            (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
<p>
Removes all handlers and unsets ownership of all 
selections for a widget. Called when widget is being
destroyed. This function will not generally be
called by applications.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td> a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> 
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-clear"></a><h3>gtk_selection_clear ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_selection_clear                 (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Event-Structures.html#GdkEventSelection"
>GdkEventSelection</a> *event);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_selection_clear</code> has been deprecated since version 2.4 and should not be used in newly-written code. Instead of calling this function, chain up from
your selection_clear_event handler. Calling this function
from any other context is illegal.</p>
</div>
<p>
The default handler for the GtkWidget::selection_clear_event
signal.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td> a <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td>
<td> the event
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if the event was handled, otherwise false

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.2</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-copy"></a><h3>gtk_selection_data_copy ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *  gtk_selection_data_copy             (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *data);</pre>
<p>
Makes a copy of a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> structure and its data.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
<td> a pointer to a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> structure.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a pointer to a copy of <em class="parameter"><code>data</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-selection-data-free"></a><h3>gtk_selection_data_free ()</h3>
<pre class="programlisting">void                gtk_selection_data_free             (<a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData">GtkSelectionData</a> *data);</pre>
<p>
Frees a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> structure returned from
<a class="link" href="gtk-Selections.html#gtk-selection-data-copy" title="gtk_selection_data_copy ()"><code class="function">gtk_selection_data_copy()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
<td> a pointer to a <a class="link" href="GtkWidget.html#GtkSelectionData" title="GtkSelectionData"><span class="type">GtkSelectionData</span></a> structure.
</td>
</tr></tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="gtk-Selections.see-also"></a><h2>See Also</h2>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a></span></p></td>
<td><p>Much of the operation of selections happens via
             signals for <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>. In particular, if you are
             using the functions in this section, you may need
             to pay attention to ::selection_get,
             ::selection_received,  and :selection_clear_event
             signals.</p></td>
</tr></tbody>
</table></div>
<p>
</p>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.11</div>
</body>
</html>
